Dev to Stable - #22

按本 fork 架构重新实现以下上游修复：

- provider/error: 重试 server_is_overloaded（25ecf0af6）
- tool/read: SUPPORTED_IMAGE_MIMES 白名单，阻止不支持的图片格式内联（51e310c9c）
- tool/task: 子 session 继承父级 external_directory 与 deny 规则（d7701dbfb）
- skill: OPENCODE_DISABLE_CLAUDE_CODE_SKILLS 仅影响 .claude，不再连带禁用 .agents（ffe0314c4）
- core/flag: 解耦 OPENCODE_DISABLE_EXTERNAL_SKILLS 与 OPENCODE_DISABLE_CLAUDE_CODE_SKILLS
- format: formatter 子进程 stdin/stdout/stderr 全部 ignore（293bb422f）
- cli/providers: auth login 子进程 stderr 改为 inherit（8e016b470）
- app/local: 恢复无 model 消息时 msg.model?.variant 链式访问，避免崩溃（9bddf7f3e）

验证：bun typecheck（opencode + core + app）clean；
bun test test/tool/task.test.ts test/format/ → 17 pass / 0 fail

记录从 anomalyco/opencode v1.14.30..v1.14.41 抽取的 28 项变更分级（Tier S/A/B/C）、跳过列表与每项 commit hash。已应用 22 项，验证全部通过。

…arch 并行 provider

C2 (d9c1838): config 支持从 wellknown 远端 URL 拉取 remote_config 并合并，
  支持模板化 headers (env 变量替换)。
C3 (a43d3e0): websearch 抽象出 mcp-websearch 工具底座，新增 Parallel provider
  支持，按会话稳定选择 provider，环境变量 OPENCODE_WEBSEARCH_PROVIDER 可覆盖，
  OPENCODE_ENABLE_PARALLEL flag 启用 Parallel。tui/ui 显示部分按 fork 规则跳过。

验证: bun typecheck clean; bun test test/tool/websearch.test.ts test/config/config.test.ts → 91 pass / 0 fail

filterCompacted 中当尾段消息位于 compaction 摘要之前时，按 [compaction..summary,
tail..pre-compaction, summary+1..end] 顺序重排，确保 LLM 看到的语境与时间顺序一致。
同步更新 compaction.test.ts 与 messages-pagination.test.ts 4 处期望断言。

…5e329)

A5：用 git 原生 diff --patch 替代手动读取文件 + structuredPatch；
增加 maxOutputBytes 限流（单文件 10MB / 总量 10MB），溢出时输出空 patch。
新增 git.patch/patchAll/patchUntracked/statUntracked 接口，Vcs 层移除 AppFileSystem 依赖。

A4：splitGitPatch 用 (?:^|\n) 分割避免内容中包含 'diff --git' 导致的误切分。
packages/ui 部分按 fork 规则跳过。

- A6 transform.ts 文本过滤改回 text !== ""（对齐上游 4e14f79）
- A8 read.test.ts 补 unsupported image mime 回退用例（bmp/tiff/avif）
- A12 skill/index.ts externalDirs 提到 if 块外（对齐上游 ffe0314 作用域）

Tier S (provider/transform 核心 12 项) + Tier A (小型修复 7 项) + Tier B (工具/技能 3 项) + Tier C (config/websearch 2 项) + REVIEW Minor 修复 3 项。
全程 typecheck 干净，10 个核心测试文件 387+ pass / 0 fail。
延后：A3 (cancel subtask 与 bash 截断 race) / A11/B3 (前端) / B5 (fork 已更严无需) / C1 (bash→shell 重命名)。
详见 .codex_plan/TODO.md。

settings.ts 重构为 HookHandler 多态分派表，支持 command/mcp/http/prompt/agent
五种 handler。8 事件白名单（删除 Notification UI 事件）：PreToolUse、
PostToolUse、UserPromptSubmit、SessionStart、SessionEnd、Stop、SubagentStop、
PreCompact。所有 handler 走 Effect.exit 兜底 silent allow，HookSpecificOutput
使用 discriminated union 防 tag 漂移。

agent handler 内置 5 工具 LLM loop（read_file/list_dir/grep/bash 只读白名单/
synthetic_output），MAX_AGENT_TURNS=200，DEFAULT_AGENT_TIMEOUT_MS=60s。bash
工具双层防御：BASH_WHITELIST_SINGLE/PAIR + FORBIDDEN_META 元字符正则；Windows
主动拒绝；MAX_BASH_OUTPUT 8000 字节截断。

session/prompt.ts 兑现 CC 协议三处语义：permissionDecision=deny 短路、
hookSpecificOutput.updatedInput 重写工具入参、UserPromptSubmit
additionalContexts 注入 user message。

permission/index.ts 删除 Notification trigger 段（13 行），与 8 事件白名单对齐。

defaultLayer 注入 FetchHttpClient + Provider + Auth + AppFileSystem +
CrossSpawnSpawner，agent loop 通过 Effect Service 获取 spawner/fs。

测试：settings.test.ts 51 PASS（12 describe，覆盖 8 事件 × WP-4A/4B/4C/4D-2/4F
矩阵 20/32），agent-tools.test.ts 12 PASS（5 describe）。typecheck 0 错。

- README/AGENTS：新增 Hook System 章节，介绍 5 handler 类型与 Test pattern
- replan/02、07、08：Notification 标 "removed in fork（走内部 bus）"
- RELEASE_NOTES：9 events → 8 events 口径修正

…ook 动态注入

- WP-5A: SessionStart additionalContexts 真兑现 — 新增 HookStartContext (InstanceState append/consume drain)，share/session.ts 在 hook 成功路径 append，prompt.ts 首轮 user message 注入
- WP-5B: continue=false 真短路 — settings.ts trigger 主循环双层 break；prompt.ts 4 个 hook 调用点 + compaction.ts PreCompact 消费 preventContinuation
- WP-5C: suppressOutput schema-only no-op 注释 — fork 默认不渲染 hook stdout
- WP-5D: Session hook 动态注入 — 新增 SessionHooks Service (add/remove/list/clear)；trigger 内合并 sessionEntries + once 自动清理；ctx.isSubAgent 翻译 Stop→SubagentStop（仅影响 session-hook 查找，不动现有静态分发）
- 测试：+9 (start-context 2, session-hooks 5, settings WP-5B 2)；全量 2361 PASS / 0 回归
- typecheck PASS

- 02-hook-system.md: 阶段 5 已实施段（4-WP 表 + 剩余 WP）
- 07-hook-1to1.md: 协议补强段（SessionStart 注入封装 / continue=false / suppressOutput / SessionHooks）
- 08-test-plan.md: Phase 5 验收矩阵 + 回归触发器
- RELEASE_NOTES.md: Hook 协议补强（阶段 5）段
- packages/opencode/AGENTS.md: Session-scoped hooks (fork extension) 子节

- WP-6A：trigger 入口加 hasHookForEvent O(1) 短路，无 hook 配置时绕过 matcher 热路径
- WP-6B：Settings 加 allowUntrusted schema 字段 + TODO 注释，等 fork trust 系统接入
- WP-6C：execShell 加 __sourceDir existsSync 预检，缺失时 silent allow（防 GC 竞态误判 deny）

测试：hook 63 PASS（+3）/ 全量 2365 PASS / 0 回归

- 02-hook-system §12: 阶段 6 P1 鲁棒性已实施
- 07-hook-1to1: 性能 / trust / plugin GC 竞态三小节
- 08-test-plan §11: Phase 6 验收矩阵
- RELEASE_NOTES: Hook 协议鲁棒性（阶段 6）段
- AGENTS.md: Hook System 章节加 Performance + Robustness

通过 CC 官方 verbatim 示例 e2e 验证（8/8 PASS），fork 是 CC hook 协议的严格超集 + 2 项行为差异：

- 6 项严格超集：case-insensitive matcher / 6 层 settings / hasHookForEvent O(1) 短路 /
  SessionHooks 动态注入 / __sourceDir GC 保护 / continue=false 双层 break
- 1 项 schema-only：allowUntrusted 字段（运行时占位）
- 2 项行为差异：suppressOutput 默认翻转（CC=false / fork=true）+ Notification 不支持

验收基线：hook 63 PASS / 全量 2365 PASS / typecheck PASS（1 PRE-EXISTING fail）

invokeMcpHook 此前用整串 "mcp__server__tool" 直接查 mcpSvc.tools()
dict，但 src/mcp/index.ts L645 注册时 key 是 sanitize(server)+"_"+sanitize(tool)
（无 mcp__ 前缀、单下划线分隔）。两边永远不匹配，type=mcp hook 在
当前 fork 实现下从未真正生效。

修复方案：在 invokeMcpHook 内 strip mcp__ 前缀、按 __ split 出
server/tool、sanitize 后用 _ rejoin 成内部 key 查 dict，保留
tools[command] 作 fallback。对外接受 CC 协议命令名，对内做格式转换。

P6a/P6b e2e 验证：gitnexus + mempalace 真插件经 type=mcp hook
将 envelope 注入 LLM 上下文，模型原文回引 marker 字符串。

graphify Bash hint 与 mempalace Glob|Grep|Read hint 在 bun run dev 启动时
cwd=packages/opencode 下永远 silent skip（相对路径 graphify-out/graph.json 找不到）= 死代码。
project-onboarding skill 严格不做清单 (L116) 已声明此类 hook 不在范围，仓基线归零。

…ug + timeout-kill warn

F4 调研发现 SettingsHook.trigger happy path 零日志输出。Effect.fn 只附 tracing
span 名、不自动 emit log，trigger / runEntry / commandHandler / execShell /
child.on('close') 都未调 log.time 也未 log.info。配合 mempalace 默认命令
'2>/dev/null || true' 的双重静默，hook 执行链对运维完全不可见。

修复（纯日志，不动控制流）：

- Fix 1 span 计时：
  - trigger 入口加 using _ = log.time('trigger', { event, sessionID })
  - runEntry 入口加 using _ = log.time('runEntry', { type, command.slice(0,80) })
  - 两个短路点（no_matchers / empty_matchers）加 log.info trigger short-circuit
- Fix 2 spawn lifecycle：
  - execShell spawn 前加 log.debug 'hook spawn'（command/cwd/timeoutMs）
  - child.on('close') 加 log.debug 'hook close'（exitCode/stdoutLen/stderrLen），
    resolve 语义不变
- Fix 3 timeout-kill latent bug：
  - exitCode === null 路径之前完全无日志（spawn 设 timeout 触发 SIGTERM 时）
  - 新增 log.warn 'hook command timed out / killed (non-blocking)'

Clean-shot 验证 — opencode run echo 命令产出 dev.log 12 行命中：
- SessionStart 完整链路：started → spawn → close → completed duration=54ms
- UserPromptSubmit 短路：started → short-circuit reason=no_matchers → completed 0ms
- Stop 完整链路：started → spawn → close → completed duration=45ms

测试：bun typecheck 0 错；test/hook/ 63/63 PASS；下游 6 套件 184/4skip/0fail。

合规：handler abstraction、trigger reducer 控制流、WP-6C existsSync pre-check
全部保持。无类型/签名/返回值变化。

Fix-1 effect-zod.ts: zod 4.4.3 的 z.toJSONSchema() 把内部 standard-schema
spec 的运行时字段 ~standard（含函数引用 validate/vendor/jsonSchema.input
等）当 metadata 一并带出，泄漏到 LLM wire payload 与 16 个 tool snapshot。
返回前 Reflect.deleteProperty(result, '~standard') 顶层 strip。snapshot
自动匹配旧 baseline。

Fix-2 truncate.ts: cleanup 原用 Identifier.timestamp(entry) 比 cutoff，但
id.ts 的进程级单调 clamp（lastTimestamp）会污染 ID 内嵌时间戳——同进程
跨测试或高频写入场景，老文件 ID timestamp 被抬回 ≈ now，cleanup 漏删。
改用 fs.stat(full).mtime 与 Date.now() - RETENTION 比较；保留 catch 容错；
mtime Option.None 时回退 +Infinity 保守不删。

测试侧补 utimes：truncation.test.ts cleanup 测试在 writeFileStringScoped
后用 fs.utimes 显式回写 old(-10d) / recent(-3d) mtime，匹配真实生产语义。

验证：
- bun typecheck 13/13 PASS
- test/tool/ 247/0 fail（含 truncation 19/19、parameters 53/53 含 16
  snapshot 匹配旧 baseline）
- test/hook/ 63/0、test/session/ 329/0 fail、test/server/ 123/0 fail

z.toJSONSchema() 返回的对象把 ~standard 设为原型链上的不可枚举属性，
Reflect.deleteProperty 对原型链属性返回 false 无效。

本地 Bun snapshot serializer 走 own-enumerable 路径不输出 ~standard，
但 CI 环境的 serializer 通过 for...in 能见到原型属性 — 导致 16 个
parameters 快照在 CI 上 fail 但本地 PASS 的假象。

改用对象展开 {...result} 拷贝 own-enumerable 键，原型回到 Object.prototype，
"~standard" in result === false，本地与 CI 行为一致。

- 删除 src/plugin/github-proxy/ 整个目录（proxy.ts）
- 从 plugin/index.ts 注销 GithubProxyAuthPlugin 注册
- 从 provider schema/provider/transform 中剥离 github-proxy 分支
- quota-fetch.ts 收窄 QuotaAuth.provider 为 github-copilot，保留 copilot 计费 TUI 链路完整
- 清理对应测试文件，保留 copilot quota 17 个用例全部通过

- 新增 quota/ 子目录（endpoint.ts / fetch.ts / view.tsx / index.ts）
- proxy 模式 URL = ${provider.github-copilot.api}/quota，parse 扁平 schema
  {remaining, entitlement, accounts_active, accounts_total}
- official 模式 URL = api.github.com/copilot_internal/user，parse 嵌套
  data.quota_snapshots.premium_interactions
- QuotaInfo 新增 mode: 'proxy'|'official' tag，view 按 accounts_total 分支
- 删除旧 quota.tsx / quota-fetch.ts / quota-fetch.test.ts
- 新增 quota.test.ts 25 用例覆盖双 schema + fetchQuota 全路径
- typecheck 0 error，全量测试 2342 pass，33.110 实调 schema 验证通过